home *** CD-ROM | disk | FTP | other *** search
DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) NNNNAAAAMMMMEEEE DtHelpDialog - DtHelpDialog widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<DDDDtttt////HHHHeeeellllppppDDDDiiiiaaaalllloooogggg....hhhh>>>> DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The DtHelpDialog widget provides users with functionality for viewing and navigating structured online information (CDE help volumes). This functionality includes text and graphics rendering, embedded hypertext links and various navigation methods to move through online help information. The widget supports rendering of CDE help volumes, system manual pages, text files and character string values. When the user resizes the window, the DtHelpDialog widget dynamically reformats its contents to fit the new window size if the DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee of the contents is DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____TTTTOOOOPPPPIIIICCCC or DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____DDDDYYYYNNNNAAAAMMMMIIIICCCC____SSSSTTTTRRRRIIIINNNNGGGG. If the DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee of the contents is DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____SSSSTTTTRRRRIIIINNNNGGGG, DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____MMMMAAAANNNN____PPPPAAAAGGGGEEEE or DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____FFFFIIIILLLLEEEE, the contents are not reformatted. Instead, scroll bars may appear when the user resizes the window smaller than the help contents. The exact scrollbar behavior is controlled by the DDDDttttNNNNssssccccrrrroooollllllllBBBBaaaarrrrPPPPoooolllliiiiccccyyyy resource. Users can re-specify certain resources for the automatically created widgets and gadgets contained within the DtHelpDialog widget hierarchy. The following list identifies the names of these widgets (or gadgets): Topic Tree - _T_o_c_A_r_e_a Display Area - _D_i_s_p_l_a_y_A_r_e_a Button Box - _B_t_n_B_o_x The DtHelpDialog widget honors all default and user- specified resource settings, with one exception. In the case where an error occurs due to an invalid request, the DtHelpDialog widget posts the proper error message in its display area and modifies the DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee resource to reflect the current contents of the display area (that is, a string message). Applications and users should set the DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee resource to the appropriate value with each setting of the DtHelpDialog widget. CCCCllllaaaasssssssseeeessss The DtHelpDialog widget inherits behavior and resources from the _C_o_r_e, _C_o_m_p_o_s_i_t_e, _C_o_n_s_t_r_a_i_n_t, _X_m_M_a_n_a_g_e_r and _X_m_B_u_l_l_e_t_i_n_B_o_a_r_d classes. The class pointer is ddddttttHHHHeeeellllppppDDDDiiiiaaaallllooooggggCCCCllllaaaassssssss. Page 1 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) The class name is _D_t_H_e_l_p_D_i_a_l_o_g. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss To reference a resource by name or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, the application must remove the DDDDttttNNNN or DDDDttttCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, the application must remove the DDDDtttt prefix and use the remaining letters (in either lower case or upper case, but including any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss() (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss() (G), or is not applicable (N/A). DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt __________________________________________________________________________ NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss __________________________________________________________________________ DDDDttttNNNNcccclllloooosssseeeeCCCCaaaallllllllbbbbaaaacccckkkk DDDDttttCCCCCCCClllloooosssseeeeCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiissssttttNULL C DDDDttttNNNNccccoooolllluuuummmmnnnnssss DDDDttttCCCCCCCCoooolllluuuummmmnnnnssss DDDDiiiimmmmeeeennnnssssiiiioooonnnn 70 CSG DDDDttttNNNNeeeexxxxeeeeccccuuuuttttiiiioooonnnnPPPPoooolllliiiiccccyyyy DDDDttttCCCCEEEExxxxeeeeccccuuuuttttiiiioooonnnnPPPPoooolllliiiiccccyyyy uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr DtHELP_- CSG EXECUTE- _QUERY- _UNALIASED DDDDttttNNNNhhhheeeellllppppFFFFiiiilllleeee DDDDttttCCCCHHHHeeeellllppppFFFFiiiilllleeee cccchhhhaaaarrrr **** NULL CSG DDDDttttNNNNhhhheeeellllppppOOOOnnnnHHHHeeeellllppppVVVVoooolllluuuummmmeeee DDDDttttCCCCHHHHeeeellllppppOOOOnnnnHHHHeeeellllppppVVVVoooolllluuuummmmeeee cccchhhhaaaarrrr **** See DefinitionC DDDDttttNNNNhhhheeeellllppppPPPPrrrriiiinnnntttt DDDDttttCCCCHHHHeeeellllppppPPPPrrrriiiinnnntttt cccchhhhaaaarrrr **** See DefinitionCSG DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee DDDDttttCCCCHHHHeeeellllppppTTTTyyyyppppeeee uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr See DefinitionCSG DDDDttttNNNNhhhheeeellllppppVVVVoooolllluuuummmmeeee DDDDttttCCCCHHHHeeeellllppppVVVVoooolllluuuummmmeeee cccchhhhaaaarrrr **** NULL CSG DDDDttttNNNNhhhhyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkkDDDDttttCCCCHHHHyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkkXXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiissssttttNULL C DDDDttttNNNNllllooooccccaaaattttiiiioooonnnnIIIIdddd DDDDttttCCCCLLLLooooccccaaaattttiiiioooonnnnIIIIdddd cccchhhhaaaarrrr **** See DefinitionCSG DDDDttttNNNNmmmmaaaannnnPPPPaaaaggggeeee DDDDttttCCCCMMMMaaaannnnPPPPaaaaggggeeee cccchhhhaaaarrrr **** NULL CSG DDDDttttNNNNppppaaaappppeeeerrrrSSSSiiiizzzzeeee DDDDttttCCCCPPPPaaaappppeeeerrrrSSSSiiiizzzzeeee uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr See DefinitionC DDDDttttNNNNpppprrrriiiinnnntttteeeerrrr DDDDttttCCCCPPPPrrrriiiinnnntttteeeerrrr cccchhhhaaaarrrr **** NULL CSG DDDDttttNNNNrrrroooowwwwssss DDDDttttCCCCRRRRoooowwwwssss DDDDiiiimmmmeeeennnnssssiiiioooonnnn 25 CSG DDDDttttNNNNssssccccrrrroooollllllllBBBBaaaarrrrPPPPoooolllliiiiccccyyyy DDDDttttCCCCSSSSccccrrrroooollllllllBBBBaaaarrrrPPPPoooolllliiiiccccyyyy uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr See DefinitionC DDDDttttNNNNssssttttrrrriiiinnnnggggDDDDaaaattttaaaa DDDDttttCCCCSSSSttttrrrriiiinnnnggggDDDDaaaattttaaaa cccchhhhaaaarrrr **** NULL CSG DDDDttttNNNNttttooooppppiiiiccccTTTTiiiittttlllleeee DDDDttttCCCCTTTTooooppppiiiiccccTTTTiiiittttlllleeee cccchhhhaaaarrrr **** NULL CSG DDDDttttNNNNvvvviiiissssiiiibbbblllleeeePPPPaaaatttthhhhCCCCoooouuuunnnntttt DDDDttttCCCCVVVViiiissssiiiibbbblllleeeePPPPaaaatttthhhhCCCCoooouuuunnnntttt iiiinnnntttt 7 C DDDDttttNNNNcccclllloooosssseeeeCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks called when the user activates the Close button. The callback reason is DDDDttttCCCCRRRR____HHHHEEEELLLLPPPP____CCCCLLLLOOOOSSSSEEEE. DDDDttttNNNNccccoooolllluuuummmmnnnnssss Specifies the number of columns of text to display in the display area of the DtHelpDialog widget. DDDDttttNNNNeeeexxxxeeeeccccuuuuttttiiiioooonnnnPPPPoooolllliiiiccccyyyy Specifies how to handle ``Execute'' hypertext link types and embedded scripts. The default value is Page 2 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) set to DDDDttttHHHHEEEELLLLPPPP____EEEEXXXXEEEECCCCUUUUTTTTEEEE____QQQQUUUUEEEERRRRYYYY____UUUUNNNNAAAALLLLIIIIAAAASSSSEEEEDDDD and supports different semantics based on the usage of a command alias. Refer to the CDE Help System Author's and Programmer's Guide for more information on command alias usage. With the default value and no command alias, a query dialog will be posted upon user selection of an execute hypertext link. The dialog will show the command that has been specified and give the user the option to ``Execute Anyway,'' ``Don't Execute'' or request help for more information. When a command alias is present for the selected link, the command will execute silently, and no query dialog will be posted. Other values for this resource are DDDDttttHHHHEEEELLLLPPPP____EEEEXXXXEEEECCCCUUUUTTTTEEEE____NNNNOOOONNNNEEEE, DDDDttttHHHHEEEELLLLPPPP____EEEEXXXXEEEECCCCUUUUTTTTEEEE____AAAALLLLLLLL and DDDDttttHHHHEEEELLLLPPPP____EEEEXXXXEEEECCCCUUUUTTTTEEEE____QQQQUUUUEEEERRRRYYYY____AAAALLLLLLLL. DDDDttttHHHHEEEELLLLPPPP____EEEEXXXXEEEECCCCUUUUTTTTEEEE____NNNNOOOONNNNEEEE forces all execute hypertext links to be ignored. DDDDttttHHHHEEEELLLLPPPP____EEEEXXXXEEEECCCCUUUUTTTTEEEE____AAAALLLLLLLL allows all execute hypertext links to be executed silently upon link selection by the user, and DDDDttttHHHHEEEELLLLPPPP____EEEEXXXXEEEECCCCUUUUTTTTEEEE____QQQQUUUUEEEERRRRYYYY____AAAALLLLLLLL forces the query dialog to be posted with every link invocation. DDDDttttNNNNhhhheeeellllppppFFFFiiiilllleeee Specifies the absolute pathname of a text file to be read and displayed. This resource is used when the DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee is set to DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____FFFFIIIILLLLEEEE. DDDDttttNNNNhhhheeeellllppppOOOOnnnnHHHHeeeellllppppVVVVoooolllluuuummmmeeee Specifies the help volume that contains the help topics for the help user-interface components in the widget. This is displayed in an instance of the DtHelpDialog widget when the user requests help from within the widget. The default value for this resource is HHHHeeeellllpppp4444HHHHeeeellllpppp, which refers to the default-supported help volume. This resource supports absolute pathnames and pathless help volume names. When just a volume name is used, the volume must be placed or linked to one of the default search locations, or one of the two help search path environment variables must be properly set. See the EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS section for more information on setting and modifying these variables. DDDDttttNNNNhhhheeeellllppppPPPPrrrriiiinnnntttt Specifies the location of the ddddtttthhhheeeellllpppppppprrrriiiinnnntttt(1) utility used to print help topics, manual-page files or help messages from the DtHelpDialog widget. This value defaults to ////uuuussssrrrr////ddddtttt////bbbbiiiinnnn////ddddtttthhhheeeellllpppppppprrrriiiinnnntttt. Page 3 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee Specifies the current topic type. When the value is DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____TTTTOOOOPPPPIIIICCCC, the DDDDttttNNNNllllooooccccaaaattttiiiioooonnnnIIIIdddd and DDDDttttNNNNhhhheeeellllppppVVVVoooolllluuuummmmeeee resources are used and the requested help topic is displayed. When the value is DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____SSSSTTTTRRRRIIIINNNNGGGG or DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____DDDDYYYYNNNNAAAAMMMMIIIICCCC____SSSSTTTTRRRRIIIINNNNGGGG, the DDDDttttNNNNssssttttrrrriiiinnnnggggDDDDaaaattttaaaa resource is used and the requested string is displayed. When the value is DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____FFFFIIIILLLLEEEE, the DDDDttttNNNNhhhheeeellllppppFFFFiiiilllleeee resource is used and the requested text file is displayed. When the value is DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____MMMMAAAANNNN____PPPPAAAAGGGGEEEE, the DDDDttttNNNNmmmmaaaannnnPPPPaaaaggggeeee resource is used and the requested system manual page is displayed. The initial default value is DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____TTTTOOOOPPPPIIIICCCC; however, each time there is a request to display a help topic, text file, manual page or text string, the user should reset DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee to the proper type. DDDDttttNNNNhhhheeeellllppppVVVVoooolllluuuummmmeeee Specifies the help volume to use. This resource is used in conjunction with the DDDDttttNNNNllllooooccccaaaattttiiiioooonnnnIIIIdddd resource to display help topics. This resource supports absolute pathnames and pathless help volume names. When using just a volume name, the volume must be placed in or linked to one of the default search locations, or one of the two help search path environment variables must be properly set. See the EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS section for more information on setting and modifying these variables. DDDDttttNNNNhhhhyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkk Specifies the callback that is called when a client-specific hypertext link is activated in the display area of the DtHelpDialog widget. Links are activated when the user presses mouse button 1 over a hypertext link, or presses <return> with the keyboard focus on the hypertext link item. The callback reason is DDDDttttCCCCRRRR____HHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE. DDDDttttNNNNhhhhyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkk allows applications to register a callback procedure that is used to process one of four hypertext link types: DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____AAAAPPPPPPPP____DDDDEEEEFFFFIIIINNNNEEEE, DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____TTTTOOOOPPPPIIIICCCC, DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____MMMMAAAANNNN____PPPPAAAAGGGGEEEE or DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____TTTTEEEEXXXXTTTT____FFFFIIIILLLLEEEE. For DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____TTTTOOOOPPPPIIIICCCC, the callback is made only when the _w_i_n_d_o_w_H_i_n_t value in the callback structure is DDDDttttHHHHEEEELLLLPPPP____NNNNEEEEWWWW____WWWWIIIINNNNDDDDOOOOWWWW. DDDDttttNNNNllllooooccccaaaattttiiiioooonnnnIIIIdddd Specifies a help topic to display. Applications reference topics within a help volume using a location ID. Location IDs are author-defined at Page 4 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) help volume creation time. Applications use these location IDs to display the desired help topic. The default value for this resource is ____HHHHOOOOMMMMEEEETTTTOOOOPPPPIIIICCCC, which refers to the help volume's top level topic. DDDDttttNNNNhhhheeeellllppppVVVVoooolllluuuummmmeeee must be set to the help volume in which the corresponding location ID resides, and DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee must be set to DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____TTTTOOOOPPPPIIIICCCC. DDDDttttNNNNmmmmaaaannnnPPPPaaaaggggeeee Specifies the system manual page to display in the current DtHelpDialog widget. This resource is used when the DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee is set to DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____---- MMMMAAAANNNN____PPPPAAAAGGGGEEEE. DDDDttttNNNNppppaaaappppeeeerrrrSSSSiiiizzzzeeee Controls the value used in the Help-Print dialog for paper size. The default value is set to DDDDttttHHHHEEEELLLLPPPP____PPPPAAAAPPPPEEEERRRRSSSSIIIIZZZZEEEE____LLLLEEEETTTTTTTTEEEERRRR. Other supported values for this resource are: DDDDttttHHHHEEEELLLLPPPP____PPPPAAAAPPPPEEEERRRRSSSSIIIIZZZZEEEE____LLLLEEEEGGGGAAAALLLL, DDDDttttHHHHEEEELLLLPPPP____PPPPAAAAPPPPEEEERRRRSSSSIIIIZZZZEEEE____EEEEXXXXEEEECCCCUUUUTTTTIIIIVVVVEEEE,,,, DDDDttttHHHHEEEELLLLPPPP____PPPPAAAAPPPPEEEERRRRSSSSIIIIZZZZEEEE____AAAA4444, DDDDttttHHHHEEEELLLLPPPP____PPPPAAAAPPPPEEEERRRRSSSSIIIIZZZZEEEE____BBBB5555. DDDDttttNNNNpppprrrriiiinnnntttteeeerrrr Specifies the printer name to be used when printing within the DtHelpDialog widget. If the value is NNNNUUUULLLLLLLL, the default value is taken from the _L_P_D_E_S_T environment variable. DDDDttttNNNNrrrroooowwwwssss Specifies the number of rows of text to display in the display area of the DtHelpDialog widget. DDDDttttNNNNssssccccrrrroooollllllllBBBBaaaarrrrPPPPoooolllliiiiccccyyyy Controls the automatic placement of scroll bars in the text display area. If it is set to DDDDttttHHHHEEEELLLLPPPP____AAAASSSS____NNNNEEEEEEEEDDDDEEEEDDDD____SSSSCCCCRRRROOOOLLLLLLLLBBBBAAAARRRRSSSS, the scroll bars are displayed only if the display area exceeds the clip area in one or both dimensions. A resource value of DDDDttttHHHHEEEELLLLPPPP____SSSSTTTTAAAATTTTIIIICCCC____SSSSCCCCRRRROOOOLLLLLLLLBBBBAAAARRRRSSSS causes the display area to display the scroll bars whenever the DtHelpDialog widget is managed, regardless of the relationship between the clip window and the display area. A value of DDDDttttHHHHEEEELLLLPPPP____NNNNOOOO____SSSSCCCCRRRROOOOLLLLLLLLBBBBAAAARRRRSSSS removes scroll bars from the DtHelpDialog widget. The default value is DDDDttttHHHHEEEELLLLPPPP____AAAASSSS____NNNNEEEEEEEEDDDDEEEEDDDD____SSSSCCCCRRRROOOOLLLLLLLLBBBBAAAARRRRSSSS. DDDDttttNNNNssssttttrrrriiiinnnnggggDDDDaaaattttaaaa Specifies the string data (cccchhhhaaaarrrr ****) to display in the current DtHelpDialog widget. This resource is used when the DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee is set to DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____---- SSSSTTTTRRRRIIIINNNNGGGG. Page 5 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) DDDDttttNNNNttttooooppppiiiiccccTTTTiiiittttlllleeee Specifies the topic title (cccchhhhaaaarrrr ****) to be used in conjunction with either the DDDDttttNNNNssssttttrrrriiiinnnnggggDDDDaaaattttaaaa or DDDDttttNNNNhhhheeeellllppppFFFFiiiilllleeee resource. The topic title is required in order to maintain an accurate and descriptive history list. The topic title is also used as the default heading for the banner page and page header when printing. When printing help topics, this resource may be ignored. DDDDttttNNNNvvvviiiissssiiiibbbblllleeeePPPPaaaatttthhhhCCCCoooouuuunnnntttt Specifies the number of items to display in the topic tree area of the widget. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss The DtHelpDialog widget inherits behavior and resources from the following named superclasses. For a complete description of each resource, see the man page for that superclass. XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt _____________________________________________________________________ NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss _____________________________________________________________________ XXXXmmmmNNNNaaaalllllllloooowwwwOOOOvvvveeeerrrrllllaaaapppp XXXXmmmmCCCCAAAAlllllllloooowwwwOOOOvvvveeeerrrrllllaaaapppp BBBBoooooooolllleeeeaaaannnn True CSG XXXXmmmmNNNNaaaauuuuttttooooUUUUnnnnmmmmaaaannnnaaaaggggeeee XXXXmmmmCCCCAAAAuuuuttttooooUUUUnnnnmmmmaaaannnnaaaaggggeeee BBBBoooooooolllleeeeaaaannnn True CG XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnFFFFoooonnnnttttLLLLiiiisssstttt XXXXmmmmCCCCBBBBuuuuttttttttoooonnnnFFFFoooonnnnttttLLLLiiiisssstttt XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt dynamic CSG XXXXmmmmNNNNccccaaaannnncccceeeellllBBBBuuuuttttttttoooonnnn XXXXmmmmCCCCWWWWiiiiddddggggeeeetttt WWWWiiiiddddggggeeeetttt dynamic SG XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn XXXXmmmmCCCCWWWWiiiiddddggggeeeetttt WWWWiiiiddddggggeeeetttt dynamic SG XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttPPPPoooossssiiiittttiiiioooonnnn XXXXmmmmCCCCDDDDeeeeffffaaaauuuullllttttPPPPoooossssiiiittttiiiioooonnnnBBBBoooooooolllleeeeaaaannnn True CSG XXXXmmmmNNNNddddiiiiaaaallllooooggggSSSSttttyyyylllleeee XXXXmmmmCCCCDDDDiiiiaaaallllooooggggSSSSttttyyyylllleeee uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr dynamic CSG XXXXmmmmNNNNddddiiiiaaaallllooooggggTTTTiiiittttlllleeee XXXXmmmmCCCCDDDDiiiiaaaallllooooggggTTTTiiiittttlllleeee XXXXmmmmSSSSttttrrrriiiinnnngggg NULL CSG XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmCCCCCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiissssttttNULL C XXXXmmmmNNNNllllaaaabbbbeeeellllFFFFoooonnnnttttLLLLiiiisssstttt XXXXmmmmCCCCLLLLaaaabbbbeeeellllFFFFoooonnnnttttLLLLiiiisssstttt XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt dynamic CSG XXXXmmmmNNNNmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmCCCCCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiissssttttNULL C XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt XXXXmmmmCCCCMMMMaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt DDDDiiiimmmmeeeennnnssssiiiioooonnnn 10 CSG XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh XXXXmmmmCCCCMMMMaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh DDDDiiiimmmmeeeennnnssssiiiioooonnnn 10 CSG XXXXmmmmNNNNnnnnooooRRRReeeessssiiiizzzzeeee XXXXmmmmCCCCNNNNooooRRRReeeessssiiiizzzzeeee BBBBoooooooolllleeeeaaaannnn False CSG XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeePPPPoooolllliiiiccccyyyy XXXXmmmmCCCCRRRReeeessssiiiizzzzeeeePPPPoooolllliiiiccccyyyy uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr XmRESIZE_ANYCSG XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTTyyyyppppeeee XXXXmmmmCCCCSSSShhhhaaaaddddoooowwwwTTTTyyyyppppeeee uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr XmSHADOW_OUTCSG XXXXmmmmNNNNtttteeeexxxxttttFFFFoooonnnnttttLLLLiiiisssstttt XXXXmmmmCCCCTTTTeeeexxxxttttFFFFoooonnnnttttLLLLiiiisssstttt XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt dynamic CSG XXXXmmmmNNNNtttteeeexxxxttttTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssssXXXXmmmmCCCCTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss XXXXttttTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssssNULL C XXXXmmmmNNNNuuuunnnnmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmCCCCCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiissssttttNULL C Page 6 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt ______________________________________________________________________ NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ______________________________________________________________________ XXXXmmmmNNNNbbbboooottttttttoooommmm---- XXXXmmmmCCCCBBBBoooottttttttoooommmm---- PPPPiiiixxxxeeeellll dynamic CSG SSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr SSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr XXXXmmmmNNNNbbbboooottttttttoooommmm---- XXXXmmmmCCCCBBBBoooottttttttoooommmm---- PPPPiiiixxxxmmmmaaaapppp XmUNSPECIFIED-CSG SSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp SSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp _PIXMAP XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd XXXXmmmmCCCCFFFFoooorrrreeeeggggrrrroooouuuunnnndddd PPPPiiiixxxxeeeellll dynamic CSG XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmCCCCCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiissssttttNULL C XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttCCCCoooolllloooorrrr XXXXmmmmCCCCHHHHiiiigggghhhhlllliiiigggghhhhttttCCCCoooolllloooorrrr PPPPiiiixxxxeeeellll dynamic CSG XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttPPPPiiiixxxxmmmmaaaappppXXXXmmmmCCCCHHHHiiiigggghhhhlllliiiigggghhhhttttPPPPiiiixxxxmmmmaaaappppPPPPiiiixxxxmmmmaaaapppp dynamic CSG XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss XXXXmmmmCCCCIIIInnnniiiittttiiiiaaaallllFFFFooooccccuuuussss WWWWiiiiddddggggeeeetttt dynamic CSG XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee XXXXmmmmCCCCNNNNaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee XXXXmmmmNNNNaaaavvvviiiiggggaaaattttiiiioooonnnn---- XmTAB_GROUP CSG TTTTyyyyppppeeee XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssssXXXXmmmmCCCCSSSShhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssssDDDDiiiimmmmeeeennnnssssiiiioooonnnn dynamic CSG XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnnXXXXmmmmCCCCSSSSttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnnXXXXmmmmSSSSttttrrrriiiinnnngggg---- dynamic CG DDDDiiiirrrreeeeccccttttiiiioooonnnn XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr XXXXmmmmCCCCTTTTooooppppSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr PPPPiiiixxxxeeeellll dynamic CSG XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaappppXXXXmmmmCCCCTTTTooooppppSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaappppPPPPiiiixxxxmmmmaaaapppp dynamic CSG XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn XXXXmmmmCCCCTTTTrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn BBBBoooooooolllleeeeaaaannnn True CSG XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee XXXXmmmmCCCCUUUUnnnniiiittttTTTTyyyyppppeeee uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr dynamic CSG XXXXmmmmNNNNuuuusssseeeerrrrDDDDaaaattttaaaa XXXXmmmmCCCCUUUUsssseeeerrrrDDDDaaaattttaaaa XXXXttttPPPPooooiiiinnnntttteeeerrrr NULL CSG CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt _________________________________________________________________ NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss _________________________________________________________________ XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn XXXXmmmmCCCCRRRReeeeaaaaddddOOOOnnnnllllyyyy WWWWiiiiddddggggeeeettttLLLLiiiisssstttt NULL G XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn XXXXmmmmCCCCIIIInnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn XXXXttttOOOOrrrrddddeeeerrrrPPPPrrrroooocccc NULL CSG XXXXmmmmNNNNnnnnuuuummmmCCCChhhhiiiillllddddrrrreeeennnn XXXXmmmmCCCCRRRReeeeaaaaddddOOOOnnnnllllyyyy CCCCaaaarrrrddddiiiinnnnaaaallll 0 G CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt _______________________________________________________________________________ NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss _______________________________________________________________________________ XXXXmmmmNNNNaaaacccccccceeeelllleeeerrrraaaattttoooorrrrssss XXXXmmmmCCCCAAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssss XXXXttttAAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssssdynamic N/A XXXXmmmmNNNNaaaannnncccceeeessssttttoooorrrrSSSSeeeennnnssssiiiittttiiiivvvveeeeXXXXmmmmCCCCSSSSeeeennnnssssiiiittttiiiivvvveeee BBBBoooooooolllleeeeaaaannnn dynamic G XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd XXXXmmmmCCCCBBBBaaaacccckkkkggggrrrroooouuuunnnndddd PPPPiiiixxxxeeeellll dynamic CSG XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnnddddPPPPiiiixxxxmmmmaaaapppp XXXXmmmmCCCCPPPPiiiixxxxmmmmaaaapppp PPPPiiiixxxxmmmmaaaapppp XmUNSPECIFIED- CSG _PIXMAP XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr XXXXmmmmCCCCBBBBoooorrrrddddeeeerrrrCCCCoooolllloooorrrr PPPPiiiixxxxeeeellll XtDefaultForegroundCSG XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrPPPPiiiixxxxmmmmaaaapppp XXXXmmmmCCCCPPPPiiiixxxxmmmmaaaapppp PPPPiiiixxxxmmmmaaaapppp XmUNSPECIFIED- CSG _PIXMAP XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh XXXXmmmmCCCCBBBBoooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh DDDDiiiimmmmeeeennnnssssiiiioooonnnn 0 CSG XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp XXXXmmmmCCCCCCCCoooolllloooorrrrmmmmaaaapppp CCCCoooolllloooorrrrmmmmaaaapppp dynamic CG XXXXmmmmNNNNddddeeeepppptttthhhh XXXXmmmmCCCCDDDDeeeepppptttthhhh iiiinnnntttt dynamic CG XXXXmmmmNNNNddddeeeessssttttrrrrooooyyyyCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmCCCCCCCCaaaallllllllbbbbaaaacccckkkk XXXXttttCCCCaaaallllllllbbbbaaaacccckkkkLLLLiiiissssttttNULL C XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt XXXXmmmmCCCCHHHHeeeeiiiigggghhhhtttt DDDDiiiimmmmeeeennnnssssiiiioooonnnn dynamic CSG XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllRRRReeeessssoooouuuurrrrcccceeeessss----XXXXmmmmCCCCIIIInnnniiiittttiiiiaaaallllRRRReeeessssoooouuuurrrrcccceeeessss----BBBBoooooooolllleeeeaaaannnn True C Page 7 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) PPPPeeeerrrrssssiiiisssstttteeeennnntttt PPPPeeeerrrrssssiiiisssstttteeeennnntttt XXXXmmmmNNNNmmmmaaaappppppppeeeeddddWWWWhhhheeeennnn---- XXXXmmmmCCCCMMMMaaaappppppppeeeeddddWWWWhhhheeeennnn---- BBBBoooooooolllleeeeaaaannnn True CSG MMMMaaaannnnaaaaggggeeeedddd MMMMaaaannnnaaaaggggeeeedddd XXXXmmmmNNNNssssccccrrrreeeeeeeennnn XXXXmmmmCCCCSSSSccccrrrreeeeeeeennnn SSSSccccrrrreeeeeeeennnn **** dynamic CG XXXXmmmmNNNNsssseeeennnnssssiiiittttiiiivvvveeee XXXXmmmmCCCCSSSSeeeennnnssssiiiittttiiiivvvveeee BBBBoooooooolllleeeeaaaannnn True CSG XXXXmmmmNNNNttttrrrraaaannnnssssllllaaaattttiiiioooonnnnssss XXXXmmmmCCCCTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss XXXXttttTTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssssdynamic CSG XXXXmmmmNNNNwwwwiiiiddddtttthhhh XXXXmmmmCCCCWWWWiiiiddddtttthhhh DDDDiiiimmmmeeeennnnssssiiiioooonnnn dynamic CSG XXXXmmmmNNNNxxxx XXXXmmmmCCCCPPPPoooossssiiiittttiiiioooonnnn PPPPoooossssiiiittttiiiioooonnnn 0 CSG XXXXmmmmNNNNyyyy XXXXmmmmCCCCPPPPoooossssiiiittttiiiioooonnnn PPPPoooossssiiiittttiiiioooonnnn 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed to each callback: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; cccchhhhaaaarrrr ****_l_o_c_a_t_i_o_n_I_d;;;; cccchhhhaaaarrrr ****_h_e_l_p_V_o_l_u_m_e;;;; cccchhhhaaaarrrr ****_s_p_e_c_i_f_i_c_a_t_i_o_n;;;; iiiinnnntttt _h_y_p_e_r_T_y_p_e;;;; iiiinnnntttt _w_i_n_d_o_w_H_i_n_t;;;; }}}} DDDDttttHHHHeeeellllppppDDDDiiiiaaaallllooooggggCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;; The _r_e_a_s_o_n argument indicates why the callback was invoked. The _e_v_e_n_t argument points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. The _l_o_c_a_t_i_o_n_I_d argument indicates the DDDDttttNNNNllllooooccccaaaattttiiiioooonnnnIIIIdddd for the current topic. This value is NNNNUUUULLLLLLLL whenever the _h_y_p_e_r_T_y_p_e value is not DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____TTTTOOOOPPPPIIIICCCC or DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____AAAAPPPPPPPP____DDDDEEEEFFFFIIIINNNNEEEE. The _h_e_l_p_V_o_l_u_m_e argument indicates the current help volume. This value is NNNNUUUULLLLLLLL whenever the _h_y_p_e_r_T_y_p_e value is not DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____TTTTOOOOPPPPIIIICCCC or DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____AAAAPPPPPPPP____DDDDEEEEFFFFIIIINNNNEEEE. The _s_p_e_c_i_f_i_c_a_t_i_o_n argument indicates any author-defined data that was contained within the hypertext link selected. This value returns NNNNUUUULLLLLLLL if no author-defined data was given. For hyperlinks of type DDDDttttHHHHEEEELLLLPPPP____MMMMAAAANNNN____PPPPAAAAGGGGEEEE, the _s_p_e_c_i_f_i_c_a_t_i_o_n argument contains the name of the manual page. For hyperlinks of type DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____TTTTEEEEXXXXTTTT____FFFFIIIILLLLEEEE, the _s_p_e_c_i_f_i_c_a_t_i_o_n argument contains that name of the file. The _h_y_p_e_r_T_y_p_e argument indicates the hypertext link type. Possible values are: DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____TTTTOOOOPPPPIIIICCCC, DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____---- MMMMAAAANNNN____PPPPAAAAGGGGEEEE, DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____AAAAPPPPPPPP____DDDDEEEEFFFFIIIINNNNEEEE or DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____TTTTEEEEXXXXTTTT____FFFFIIIILLLLEEEE. The _w_i_n_d_o_w_H_i_n_t argument indicates a hint for the type of window (quick help, existing or new window) to use. This value contains one of the following three types: Page 8 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) DDDDttttHHHHEEEELLLLPPPP____PPPPOOOOPPPPUUUUPPPP____WWWWIIIINNNNDDDDOOOOWWWW, DDDDttttHHHHEEEELLLLPPPP____CCCCUUUURRRRRRRREEEENNNNTTTT____WWWWIIIINNNNDDDDOOOOWWWW or DDDDttttHHHHEEEELLLLPPPP____NNNNEEEEWWWW____WWWWIIIINNNNDDDDOOOOWWWW. AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr The DtHelpDialog widget has the additional behavior described below: <_M_A_n_y> <_K_C_a_n_c_e_l> Calls the active callbacks for the Close button. If a <_B_D_r_a_g> for either a selection or scrollbar movement is in process, the <_K_C_a_n_c_e_l> aborts that action. <_K_S_p_a_c_e>, <_K_A_c_t_i_v_a_t_e> or <_B_S_e_l_e_c_t> in Topic Tree Text Opens the help topic currently selected, displays that topic in the display area and updates the topic tree to match the newly displayed topic. <_K_S_p_a_c_e>, <_K_A_c_t_i_v_a_t_e> or <_B_S_e_l_e_c_t> in Display Area Text Invokes the hypertext link that contains the current selection. <_D_o_u_b_l_e_C_l_i_c_k> in Topic Tree or Display Area Text Ignored. <_B_D_r_a_g> in Topic Tree or Display Area Text Selects the text from the drag start point to the drag end point. Moving and holding the <_B_D_r_a_g> outside the topic tree or display area scrolls the window, selecting the newly exposed text. <_M_C_t_r_l> or <_M_S_h_i_f_t> <_B_S_e_l_e_c_t> in Topic Tree Text <_M_C_t_r_l> <_K_S_p_a_c_e> in Topic Tree Text <_M_C_t_r_l> <_K_A_c_t_i_v_a_t_e> in Topic Tree Text Invokes the DDDDttttNNNNhhhhyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkk for the DtHelpDialog widget, setting the _h_e_l_p_T_y_p_e to DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____TTTTOOOOPPPPIIIICCCC, the _w_i_n_d_o_w_H_i_n_t to DDDDttttHHHHEEEELLLLPPPP____NNNNEEEEWWWW____WWWWIIIINNNNDDDDOOOOWWWW, the _h_e_l_p_V_o_l_u_m_e to the current volume name and the _l_o_c_a_t_i_o_n_I_d to the selected item's location ID. If no DDDDttttNNNNhhhhyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkk is supplied, the action is ignored. Text <_M_C_t_r_l> or <_M_S_h_i_f_t> <_B_S_e_l_e_c_t> in Display Area Hypertext Link Invokes the DDDDttttNNNNhhhhyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkk for the DtHelpDialog widget, honoring all existing link settings, but forces the _w_i_n_d_o_w_H_i_n_t to DDDDttttHHHHEEEELLLLPPPP____NNNNEEEEWWWW____WWWWIIIINNNNDDDDOOOOWWWW. If no DDDDttttNNNNhhhhyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkk is supplied, the hypertext link is handled internally. <_K_S_e_l_e_c_t_A_l_l> in Display Area or Topic Tree Page 9 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) Selects all text within the topic tree area or display area. <_K_D_e_S_e_l_e_c_t_A_l_l> in Display Area or Topic Tree Deselects all text within the topic tree area or display area. <_K_U_p> or <_K_L_e_f_t> in Display Area or Topic Tree Moves the traversal highlight up or left to the next hypertext link item. <_K_D_o_w_n> or <_K_R_i_g_h_t> in Display Area or Topic Tree Moves the traversal highlight down or right to the next hypertext item. <_K_C_o_p_y> in the Display Area or Topic Tree Copies the currently selected text to the clipboard. <_K_P_a_g_e_D_o_w_n> or <_M_C_t_r_l> <_K_D_o_w_n> in Display Area or Topic Tree Displays the next page of text. <_K_P_a_g_e_L_e_f_t> or <_M_C_t_r_l> <_K_L_e_f_t> in Display Area or Topic Tree Scrolls the information to the left. <_K_P_a_g_e_R_i_g_h_t> or <_M_C_t_r_l> <_K_R_i_g_h_t> in Display Area or Topic Tree Scrolls the information to the right. <_K_P_a_g_e_U_p> or <_M_C_t_r_l> <_K_U_p> in Display Area or Topic Tree Displays the previous page of information. <_K_B_e_g_i_n_D_a_t_a> in the Display Area or Topic Tree Displays the first page of information. <_K_E_n_d_D_a_t_a> in the Display Area or Topic Tree Displays the last page of information. VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss The bindings for virtual keys are implementation-dependent. For information about bindings for virtual buttons and keys, see VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3X). EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS The DtHelpDialog widget uses two environment variables for locating help volumes within the desktop environment: _D_T_H_E_L_P_S_E_A_R_C_H_P_A_T_H The system search path environment variable for locating help volumes on local and remote NFS mounted systems. _D_T_H_E_L_P_U_S_E_R_S_E_A_R_C_H_P_A_T_H Page 10 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) The search path environment variable for locating user-specific help volumes on local and remote NFS mounted systems. The environment variables contain colon-separated lists of directory paths. Each directory path can contain both environment variable names as well as special field descriptors that are expanded at runtime. Field descriptors consist of a percent-sign character (%) followed by a single character. Field descriptors and their substitution values are: %%%%HHHH Replaced with the current volume name being searched for. %%%%LLLL Replaced with the current value of the _L_A_N_G environment variable. %%%%%%%% Replaced with a single %. The default value for _D_T_H_E_L_P_U_S_E_R_S_E_A_R_C_H_P_A_T_H is: $$$$HHHHOOOOMMMMEEEE////....ddddtttt////hhhheeeellllpppp////$$$$DDDDTTTTUUUUSSSSEEEERRRRSSSSEEEESSSSSSSSIIIIOOOONNNN////%%%%HHHH:::: $$$$HHHHOOOOMMMMEEEE////....ddddtttt////hhhheeeellllpppp////$$$$DDDDTTTTUUUUSSSSEEEERRRRSSSSEEEESSSSSSSSIIIIOOOONNNN////%%%%HHHH....ssssddddllll:::: $$$$HHHHOOOOMMMMEEEE////....ddddtttt////hhhheeeellllpppp////$$$$DDDDTTTTUUUUSSSSEEEERRRRSSSSEEEESSSSSSSSIIIIOOOONNNN////%%%%HHHH....hhhhvvvv:::: $$$$HHHHOOOOMMMMEEEE////....ddddtttt////hhhheeeellllpppp////%%%%HHHH:::: $$$$HHHHOOOOMMMMEEEE////....ddddtttt////hhhheeeellllpppp////%%%%HHHH....ssssddddllll:::: $$$$HHHHOOOOMMMMEEEE////....ddddtttt////hhhheeeellllpppp////%%%%HHHH....hhhhvvvv The _D_T_H_E_L_P_U_S_E_R_S_E_A_R_C_H_P_A_T_H is first searched for the requested volume. If the volume is not found, the _D_T_H_E_L_P_S_E_A_R_C_H_P_A_T_H value is searched. The default value for _D_T_H_E_L_P_S_E_A_R_C_H_P_A_T_H path is: ////eeeettttcccc////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////%%%%LLLL////%%%%HHHH:::: ////eeeettttcccc////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////%%%%LLLL////%%%%HHHH....ssssddddllll:::: ////eeeettttcccc////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////%%%%LLLL////%%%%HHHH....hhhhvvvv:::: ////eeeettttcccc////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////CCCC////%%%%HHHH:::: ////eeeettttcccc////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////CCCC////%%%%HHHH....ssssddddllll:::: ////eeeettttcccc////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////CCCC////%%%%HHHH....hhhhvvvv:::: ////uuuussssrrrr////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////%%%%LLLL////%%%%HHHH:::: ////uuuussssrrrr////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////%%%%LLLL////%%%%HHHH....ssssddddllll:::: ////uuuussssrrrr////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////%%%%LLLL////%%%%HHHH....hhhhvvvv:::: ////uuuussssrrrr////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////CCCC////%%%%HHHH:::: ////uuuussssrrrr////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////CCCC////%%%%HHHH....ssssddddllll:::: ////uuuussssrrrr////ddddtttt////aaaappppppppccccoooonnnnffffiiiigggg////hhhheeeellllpppp////CCCC////%%%%HHHH....hhhhvvvv AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE The following messages can be generated as a result of an error or improperly set resource value in the DtHelpDialog Page 11 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) widget. These messages are displayed in the widget's display area as well as standard error. EEEErrrrrrrroooorrrr MMMMeeeessssssssaaaaggggeeeessss SSSSttttrrrriiiinnnngggg ddddaaaattttaaaa ccccoooouuuulllldddd nnnnooootttt bbbbeeee ffffoooorrrrmmmmaaaatttttttteeeedddd.... The error occurred when formatting help information of type DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____SSSSTTTTRRRRIIIINNNNGGGG. DDDDyyyynnnnaaaammmmiiiicccc ssssttttrrrriiiinnnngggg ddddaaaattttaaaa ccccoooouuuulllldddd nnnnooootttt bbbbeeee ffffoooorrrrmmmmaaaatttttttteeeedddd.... The error occurred when formatting help information of type DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____DDDDYYYYNNNNAAAAMMMMIIIICCCC____SSSSTTTTRRRRIIIINNNNGGGG. MMMMaaaannnn PPPPaaaaggggeeee ccccoooouuuulllldddd nnnnooootttt bbbbeeee ffffoooorrrrmmmmaaaatttttttteeeedddd.... TTTThhhheeee rrrreeeeqqqquuuueeeesssstttteeeedddd mmmmaaaannnn ppppaaaaggggeeee iiiissss eeeeiiiitttthhhheeeerrrr nnnnooootttt pppprrrreeeesssseeeennnntttt,,,, oooorrrr ccccoooorrrrrrrruuuupppptttt.... The error occurred when formatting help information of type DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____MMMMAAAANNNN____PPPPAAAAGGGGEEEE. TTTTeeeexxxxtttt ffffiiiilllleeee ccccoooouuuulllldddd nnnnooootttt bbbbeeee ffffoooorrrrmmmmaaaatttttttteeeedddd.... TTTThhhheeee rrrreeeeqqqquuuueeeesssstttteeeedddd tttteeeexxxxtttt ffffiiiilllleeee iiiissss eeeeiiiitttthhhheeeerrrr nnnnooootttt pppprrrreeeesssseeeennnntttt,,,, oooorrrr ccccoooorrrrrrrruuuupppptttt.... The error occurred when formatting help information of type DDDDttttHHHHEEEELLLLPPPP____TTTTYYYYPPPPEEEE____FFFFIIIILLLLEEEE. NNNNoooonnnn----ssssuuuuppppppppoooorrrrtttteeeedddd DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee vvvvaaaalllluuuueeee uuuusssseeeedddd.... The application used a non-supported DDDDttttNNNNhhhheeeellllppppTTTTyyyyppppeeee. HHHHeeeellllpppp ttttooooppppiiiicccc ccccoooouuuulllldddd nnnnooootttt bbbbeeee ffffoooorrrrmmmmaaaatttttttteeeedddd.... The application attempted to access a corrupt runtime help file. NNNNoooo DDDDttttNNNNhhhhyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkk ssssuuuupppppppplllliiiieeeedddd ffffoooorrrr wwwwiiiiddddggggeeeetttt.... A hypertext link of type DDDDttttHHHHEEEELLLLPPPP____NNNNEEEEWWWW____WWWWIIIINNNNDDDDOOOOWWWW has been selected, but the application has not supplied a hypertext callback to handle it. The link is handled like a DDDDttttHHHHEEEELLLLPPPP____CCCCUUUURRRRRRRREEEENNNNTTTT____WWWWIIIINNNNDDDDOOOOWWWW jump. NNNNoooonnnneeeexxxxiiiisssstttteeeennnntttt DDDDttttNNNNllllooooccccaaaattttiiiioooonnnnIIIIdddd.... The requested DDDDttttNNNNllllooooccccaaaattttiiiioooonnnnIIIIdddd is not present in the current help volume. NNNNoooo DDDDttttNNNNhhhhyyyyppppeeeerrrrLLLLiiiinnnnkkkkCCCCaaaallllllllbbbbaaaacccckkkk ssssuuuupppppppplllliiiieeeedddd ffffoooorrrr wwwwiiiiddddggggeeeetttt.... A hypertext link of type DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____AAAAPPPPPPPP____DDDDEEEEFFFFIIIINNNNEEEE or DDDDttttHHHHEEEELLLLPPPP____LLLLIIIINNNNKKKK____MMMMAAAANNNN____PPPPAAAAGGGGEEEE is selected, but the application has not supplied a hypertext callback to handle these link types. CCCCoooouuuulllldddd nnnnooootttt ffffiiiinnnndddd DDDDttttNNNNhhhheeeellllppppVVVVoooolllluuuummmmeeee.... The Help System is unable to find the help volume requested. CCCCoooouuuulllldddd nnnnooootttt ooooppppeeeennnn DDDDttttNNNNhhhheeeellllppppVVVVoooolllluuuummmmeeee.... The Help System found the requested help volume, but does not have the permission to open it. Page 12 (printed 11/11/03) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((1111 AAAAuuuugggguuuusssstttt 1111999999995555)))) DDDDttttHHHHeeeellllppppDDDDiiiiaaaalllloooogggg((((3333)))) SSSSEEEEEEEE AAAALLLLSSSSOOOO DDDDttttHHHHeeeellllppppQQQQuuuuiiiicccckkkkDDDD(5), DDDDttttHHHHeeeellllpppp(5), DDDDttttCCCCrrrreeeeaaaatttteeeeHHHHeeeellllppppQQQQuuuuiiiicccckkkkDDDDiiiiaaaalllloooogggg(3), DDDDttttHHHHeeeellllppppSSSSeeeettttCCCCaaaattttaaaallllooooggggNNNNaaaammmmeeee(3); XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3X), XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd(3X), CCCCoooorrrreeee(3X), CCCCoooommmmppppoooossssiiiitttteeee(3X), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3X), _d_t_h_e_l_p_t_a_g_d_t_d(4). Page 13 (printed 11/11/03) 
